Changes the maximum setting of a control and redraws its indicator or scroll box accordingly.

void SetControlMaximum (
    ControlRef theControl, 
    SInt16 newMaximum
);

theControl

A handle to the control whose maximum setting you wish to change.

newMaximum

The new maximum setting.

DISCUSSION

The SetControlMaximum function changes the contrlMax field of the control structure to the setting you specify in the newMaximum parameter and redraws its indicator or scroll box to reflect its new range.

When you set the maximum setting of a scroll bar equal to its minimum setting, the control definition function makes the scroll bar inactive. When you make the maximum setting exceed the minimum, the control definition function makes the scroll bar active again.

When you create a control, you specify an initial maximum setting either in the control resource or in the max parameter of the function NewControl. To determine a control’s current maximum setting, use the function GetControlMaximum.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)